# Image flashing

***Copyright © Quectel Wireless Solutions Co., Ltd. 2026. All rights reserved.***

---

Before flashing images for **Quectel Pi H1**, please ensure that the **Qualcomm_USB_Driver_v1.0.10065.1** driver has been installed. If not installed, you can [click here to download and install the driver](<https://www.quectel.com.cn/wp-content/uploads/2026/08/Qualcomm_USB_Driver_v1.0.10065.1.zip>).

# Use QDL flash software

## Ensure ModemManager tool is not running

- Prerequisite: If you are using **Linux** distribution **systemd**, some **Linux** distributions may include the **ModemManager** tool, which allows configuration of mobile broadband. When a device is connected in **USB** mode, it will be recognized as a **Qualcomm** modem, and **ModemManager** will attempt to configure the device. Since this interferes with **QDL** flashing, **ModemManager** must be disabled before connecting the device. Please use the following command to disable the **ModemManager** tool:

```bash
sudo systemctl stop ModemManager
```

## Flash image

Open **EMG_DOWNLOAD** and power on the module. The module will enter **QDL** emergency download mode.

- **Linux x64**

-  

- Windows x64

**Download QDL Tool:**[Click to download for Linux x64](<https://www.quectel.com.cn/wp-content/uploads/2026/08/QDL_Linux_x64.zip>)

1. Extract the QDL_Linux_x64 archive, and open a terminal window in the directory containing the firmware, **rawprogram.xml, patch.xml**, and **QDL** binary files.

2. Use the following command to run the **QDL** executable file in the **QDL_Linux_x64** directory to perform software flashing.

```bash
./qdl --storage ufs prog_firehose_Qcm6490_ddr.elf rawprogram*.xml patch*.xml
```

If you see **"partition 1 is now bootable"** in the terminal window, it indicates successful flashing, as shown in the following message:

```{image} images/image_O8UCbvetvot0a1xKXUJcNr1PnNd.webp
:width: 1064px
:height: 558px
```

After successful flashing, running the **lsusb** command will show device information in the terminal window, as shown in the following information:

```{image} images/image_XlJgbiEnToPukHxAtdIcex9onmh.webp
:width: 808px
:height: 151px
```

## Note

If flashing fails, please perform the following steps and retry the flashing process:

1. Turn off the device power.

2. Disconnect from **Quectel Pi H1**.

3. Restart **Quectel Pi H1**.

# QFIL image flashing

If you have **QFIL** flashing software installed on your computer, you can use it to flash images.

## Configure QFIL

Click the menu bar **Tools** → **Configuration**, and make the following settings in the configuration window:

1. In **Device Type**, select `ufs`.

2. In **Validation Mode**, select `0 - No Validation`.

3. Click **OK** to save the configuration.

```{image} images/image_Fwgtb5A7Eo9nqxxHly4cZu34nyc.webp
:width: 800px
:height: 599px
```

## Flashing steps

4. **Select port**

- Long press the **EMG_DOWNLOAD** button on **Quectel Pi H1** and power **Quectel Pi H1** on at the same time.

- Click the **SelectPort** button, select the **9008** port, and click **OK**.

5. **Select build type**

- In **Select Build Type**, select `Flat Build`.

6. **Select programmer file**

- Click the **Browse** button.

- Select the `prog_firehose_Qcm6490_ddr.elf` file.

7. **Load XML configuration files**

- Click the **Load XML** button.

- Select all `rawprogram*.xml` and `patch*.xml` files.

8. **Start flashing**

- Click the **Download** button to start flashing.

- When the **Status** area displays **Download Succeed**, it indicates successful flashing.

- The system will automatically restart.

```{image} images/image_HTJDbj0NPocDotxelhDcrupunJb.webp
:width: 800px
:height: 599px
```